home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Topik / Topik - Disk 14 - Useful Commands (19xx)(Topik Public Domain)(PD)[WB].zip / Topik - Disk 14 - Useful Commands (19xx)(Topik Public Domain)(PD)[WB].adf / GeoTime / readme < prev    next >
Text File  |  1989-08-07  |  10KB  |  237 lines
  1.  
  2. *** TOPIK Note : As usual, the relevant files are accessible from the CLI in
  3. this directory.
  4.  
  5.  
  6.                   Geotime - The "Ultimate" (?) Amiga clock
  7.  
  8.                        Copyright 1988 by Mike Smithwick
  9.  
  10. Like many people, I was getting pretty board with the plethora of rather
  11. dull little workbench clocks (mouse pointer clocks, Boing clocks, etc), I
  12. decided to write Geotime. 
  13.  
  14. Geotime actually consists of two separate programs, Geotime_m depicts a 
  15. earth map with day and nite sides shaded. You'll be able to observe the
  16. earth's shadow scroll across the map in real-time based on the system clock.
  17.  
  18. The other program, Geotime_g is a workbench clock, and shows the earth as a 
  19. globe with day and nite sides. Like the map, the shadows will progress in
  20. real-time showing the current phase of the earth.
  21.  
  22. And now a word from our sponsor:
  23.  
  24. Geotime is freely distributable, as long as this notice stays intact.
  25. However, this is, "Shareware" (oh no Mr. Bill, not shareware!). Wait! Don't
  26. go!! I know that the shareware concept is much overused, particularly since
  27. most shareware products aren't worth it. If you do enjoy this program, I would
  28. enjoy, say, $17. This will ensure a free upgrade which will not be
  29. freely distributable. Please feel free to  suggest further features for the 
  30. next version. I expect to have higher detailed maps, zoom in/out, time-
  31. zone boarders, etc.
  32.  
  33. Mail you generous cash contributions to :
  34.  
  35.                 Mike Smithwick
  36.                 25215 La Loma Drive
  37.                 Los Altos Hills, CA   94022
  38.  
  39. This of course assumes that there is enough interest to warrent further time
  40. spent on this.
  41.  
  42. "And we thank you for your support".
  43.  
  44.  
  45. ----------------------------------------------------------------------
  46.  
  47.                                  Geotime_m
  48.  
  49. Geotime_m will display a map of the earth showing the current day and
  50. nite regions. The shadow will scroll across the map in real time.
  51. This program was inspired by "Geochron", the beautiful, illuminated large wall
  52. map that costs around $4 million bucks (actually, about 2 grand).
  53.  
  54. It is started in the traditional double-click icon method. For those who
  55. despise workbench, it may be started up from CLI by typing 
  56. "geotime_m -f coast2.sm.bin".
  57.  
  58. City and country names are read from the file "gtnames.dat". Each
  59. entry requires 3 lines in the following format :
  60.  
  61.                       name
  62.                       lat long
  63.                       time_zone
  64.  
  65. West longtitude is negative, East is positive. The time-zone is the value
  66. the must be added to your time to equal Universal Time. Most almanacs should
  67. have timezone entries for major cities.
  68.  
  69. Here's a sample entry :
  70.  
  71.                        .San Francisco
  72.                        38 -122
  73.                        7
  74.                        .Seoul
  75.                        37 127
  76.                        -9
  77.                        .London
  78.                        51 0
  79.                        -100
  80.  
  81. Time zones are floating point values since some zones are fractional hours.
  82. (The timezones in the sample file may not be correct due to the uncertainties
  83. of Daylight times around the world).
  84.  
  85. Each name will automatically be followed by a clock showing the time in
  86. 24 hour mode. Using a time-zone value of "-100" (as in the London entry)
  87. will prevent the clock from being displayed to avoid excess screen clutter.
  88.  
  89. The period before the name is used to more clearly pinpoint the location.
  90.  
  91. The star-like sprite shows the "sub-solar" point, the point on the Earth
  92. directly under the sun.
  93.  
  94. There are a couple of options you may change by use of the Workbench
  95. Icon "Tooltypes" facilities. These are used to pass startup information on to a
  96. program. Click once on the icon, then select "info" from the workbench
  97. menu. You will now see the "Info" window displaying all sorts of curious
  98. attributes about it's associated file. Near the bottom is the "TOOL TYPES"
  99. string gadget. Click on the arrows, and you see 3 different startup options.
  100. "GLOBEDATA" tells the program where to get it's map data file. For Geotime_m
  101. there is currently only one file, "coast2.sm.bin", so you don't need to touch
  102. this unless you move the datafile over into another directory. Next is the
  103. "TIMEZONE" argument. This is the timezone for your location, and is determined
  104. the same way as all other timezones. The program uses this to convert the local
  105. time on your system's internal clock to Universal time. It is currently set up
  106. for Pacific time. You may also change the landmass colors using "LANDCOLOR".
  107. The following 3 numbers are the red, green and blue components. So if you wanted
  108. magenta land you would type "LANDCOLOR=15,0,15", or all red, no green, all blue.
  109. (The color values go frome 0 to 15). When done modifying the tooltypes, click
  110. on save. You may want to open the info window one more time to verify that your
  111. numbers were correctly recorded, as I ran in to some problems in this regard.
  112.  
  113. Geotime_m requires the use of a special font, "flow_thin". In order to
  114. install the font, open a cli window and type "execute gt:font_install".
  115.  
  116. There are a couple of menu options that allow you to toggle on/off the
  117. clocks, names, and a clock in the menubar.
  118.  
  119. ---------------------------------------------------------------
  120.  
  121.                                  geotime_g
  122.  
  123.  
  124. Geotime_g will depict the earth as if you will an astronaut orbiting about
  125. 300 zillion miles up. The earth's shadow will be correct for the date and
  126. time, and will advance as time itself advances.
  127.  
  128. Start this up via the icon, or CLI as mentioned above using 
  129. "geotime_g -f coast2.bin". (Notice that different data files are used for
  130. each program).
  131.  
  132. At startup you are in "orbit" mode, in which the viewpoint in effect 
  133. "orbits" around the planet. (otherwise it would be a really boring display.)
  134.  
  135. Geotime will work in both interlace and non-interlaced modes. Although
  136. it looks the niftiest in Hi-res interlace with dropshadow.
  137.  
  138. Since Geotime uses your own workbench colors you may have reset your
  139. preference colors for what looks best on both Geotime and your workbench.
  140. Colors are very important. The water should be dark-blue, land masses
  141. brown/orange or green, sky-black. In order to see the colors I used, 
  142. I've included my own "system-configuration" file on the disk which 
  143. hold my preference data. You may want to substitute this for your own 
  144. in the df0:devs directory.
  145.  
  146. There is just one Tooltype entry for this one, and that is "GLOBEDATA". 
  147. As with the Geotime_m, there is currently only 1 file, "coast2.bin".
  148.  
  149. If the globe is not circular, your monitor may need some adjustment.
  150. It may take an update or two for any changes in the settings window
  151. to take affect.
  152.  
  153. Geotime_g has several menu options. . .
  154.  
  155.                              System menu
  156.  
  157. In the systems menu, "settings" will allow you to set some basic
  158. information needed. Timezone is the number of hours which you need to 
  159. add to your local time to arrive at Universal Coordinated Time (the old 
  160. "GMT"). +7 is good for the SF Bay Area.
  161.  
  162. View lat : sets the viewer latitude. Defaults to 0 degrees. (dd.mm format)
  163.      Setting this positive will put you above the equator when looking
  164.     at the globe.
  165.  
  166. View long : sets the viewer longtitude. Defaults to 0 degrees. This advances
  167.      5 degrees each update while in orbit mode.
  168.  
  169. Lat : user's latitude. Put your home's latitude here for the "location"
  170.      highlight option. 
  171.  
  172. Long : user's latitude. Put your home's longtitude here.
  173.  
  174. Save : This will save all of your settings to a file, "geotime.dat".
  175.  
  176. If you make a mistake, the screen will flash a bunch of times and you won't
  177. be able to leave the requestor.
  178.  
  179. The latitudes go from -90 to +90 degrees. Longtitudes go from 180 W to 0 to
  180. 180 E. So for instance, the longtitude for San Francisco, 122:27 degrees 
  181. West, would be entered as "122.27 W".
  182.  
  183.                           Neat Stuff menu
  184.  
  185. Highlights : "Continents" will put an outline on the land masses. 
  186.      "Location" will put a "*" at whatever location you specify in 
  187.     the settings window.
  188.  
  189. Indicators : "Clock" will display the current date and time, while
  190.      "legend" shows how the sunny side is colored vs. the shaded side.
  191.  
  192. Mode : This lets you toggle between the orbit/hover rotational modes. 
  193.      "Orbit", the default, presents the planet to you as if you were
  194.     orbiting around in a very fast spacecraft from West to East. "Hover" 
  195.     puts you above a fixed point specified by the view lat/view long 
  196.     entries in the settings window. Hover is a really dull mode.
  197.  
  198. Shadow : "Shaded", the default, gives you a shadow tint, while "black" will
  199.      completely blacken the shadow to more closely mimic the view from 
  200.     space.
  201.  
  202. ---------------------------------------------------------------------
  203.  
  204.                                      Misc
  205.  
  206. The data used contains about 3000 points culled from a 6000 point
  207. database. (I may release the larger one sometime, it doesn't look that much
  208. better on the globe, but it is quite nice on the map).
  209.  
  210.  
  211. ---------------------------------------------------------------------
  212. (Warning! Warning! The following is an unabashed commercial announcement!)
  213.  
  214. If you do enjoy this program, you may want to take a look at something else
  215. I've done. It's called "Galileo", and is an astronomy simulation. It will
  216. display up to 9100 stars in a fashion more realistic than any other
  217. micro-computer planetarium simulation.
  218.  
  219. Galileo has won an award in the May Consumer Electronics Show for the most
  220. innovative Educational Program of the Year.
  221.  
  222. A recent review in Sky and Telescope magazine called Galileo "powerful and
  223. visually stunning", and many users write in to me saying things like
  224. "at last, a program that justifies my Amiga", or "Wonderful!".
  225.  
  226. Galileo is not meant just for folks with a telescope, but for anyone who
  227. has ever wondered about what's up in the night sky. (As a matter of fact,
  228. only a handful of owners stated they had a telescope. But those who do
  229. love the program).
  230.  
  231. So, when you're tired of exploring fictional universes, give the real
  232. one a shot, I think you'll enjoy it.
  233.  
  234.              (End of the unabashed commercial announcement!)
  235.  
  236.  
  237.